home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 21 / Cream of the Crop 21 (Terry Blount) (October 1996).iso / bbs / fflst101.zip / FFLIST.DOC next >
Text File  |  1996-07-30  |  9KB  |  209 lines
  1.                    ▄██████ ▄██████ ██      ▐██▌ ▄█████▄ ███████
  2.                    ██▄▄▄▄  ██▄▄▄▄  ██       ██  ██▄▄▄▄    ▐█▌
  3.                    ██▀▀▀▀  ██▀▀▀▀  ██       ██   ▀▀▀▀██   ▐█▌
  4.                    ██      ██      ███████ ▐██▌ ▀█████▀   ▐█▌
  5.  
  6.                                      v1.01
  7.  
  8.                   Copyright 1995-1996 by Tri-Write Development
  9.                               All Rights Reserved
  10.  
  11.                            Released: July 30th, 1996
  12.  
  13.  
  14.   ┌────────────────────────────────────────────────────────────────────────┐
  15.   │                              Introduction                              │
  16.   └────────────────────────────────────────────────────────────────────────┘
  17.  
  18. FFLIST is a file list generator that supports include/exclude files and
  19. directories, header files, footer files, and has many other features that you
  20. may find useful.
  21.  
  22.  
  23.   ┌────────────────────────────────────────────────────────────────────────┐
  24.   │                                Operation                               │
  25.   └────────────────────────────────────────────────────────────────────────┘
  26.  
  27. Syntax:
  28.           FFLIST <Output File> [Options]
  29.  
  30. Options:
  31.  
  32.     /#            NUMBER OF DOWNLOADS            (DEFAULT = OFF)
  33.  
  34.          Will include how many times each file has been downloaded at the
  35.          end of each file description, example:
  36.  
  37.          File Description Line #1
  38.          ...
  39.          File Description Line #9
  40.          Downloaded 1234 time(s)
  41.  
  42.     /D:<days>     DAYS NEW                       (DEFAULT = 7)
  43.  
  44.          This sets how many days old a file may be to be considered "new".
  45.          This defaults to 7 days, and can be set to 0 to disable marking
  46.          "new" files.  New files are marked with an '*' in the file listing.
  47.          This option is used in combination with /N to only include files
  48.          newer than <days> in the listing.
  49.  
  50.     /F:<file>     FOOTER FILE                    (DEFAULT = NONE)
  51.  
  52.          The /F option will make FFLIST copy <file> to the end of the file
  53.          list.  One use for this would be a list of magic names users can
  54.          F'REQ from your system to get the latest version(s) of file(s).
  55.  
  56.     /H:<file>     HEADER FILE                    (DEFAULT = NONE)
  57.  
  58.          The /H option will make FFLIST copy <file> to the beginning of the
  59.          file list.  This is so you can add a title (or BBS Ad, etc.) to the
  60.          beginning of the file list.
  61.  
  62.     /I:<file>     INCLUDE FILES/DIRECTORIES      (DEFAULT = ALL)
  63.  
  64.          If the /I switch is used, FFLIST will ONLY include the file bases
  65.          and files listed in <file>.  <file> should be a text file with one
  66.          file base or file listed on each line.  Wildcards me be used for
  67.          file base names, file base numbers, and file names.  Examples:
  68.  
  69.          FILEBASE   Will not list any files in FILEBASE (*.FB filename)
  70.          FILE*      Will not list any files in any *.FB filename matching
  71.                     FILE* (eg: FILE, FILEA, FILE1234, FILEWXYZ).
  72.          #:5        Will not list any files in filebase #5
  73.          #:1?       Will not list any files in filebases 10-19 (1? = 10..19)
  74.          *.GIF      Will not list any *.GIF files in any filebase
  75.  
  76.          You can use the standard DOS ? and * wildcards, as well as the
  77.          following "extended wildcards":
  78.  
  79.          [?????] Allow you to select specific characters, examples:
  80.  
  81.                  [1234]ABCD[5678]
  82.  
  83.                  Would match 1ABCD5, or 2ABCD5, or 3ABCD7, etc.
  84.  
  85.          [??-??] Allow you to select a range of characters, examples:
  86.  
  87.                  [0-5]*
  88.  
  89.                  Would match 0*, 1*, 2*, 3*, 4*, 5*
  90.  
  91.                  [1-37-9]
  92.  
  93.                  Would match 1*, 2*, 3*, 7*, 8*, 9*
  94.  
  95.          [!????] Will NOT match specific characters to exclude, examples:
  96.  
  97.                  [!1234]*
  98.  
  99.                  Would match 5*, 6*, 7*, 8*, 9*, A*, B*, but not 1*, 2*, etc.
  100.  
  101.  
  102.     /L:<xxxx>     LIMIT MOST POPULAR FILES       (DEFAULT = 20)
  103.  
  104.          Will make the most popular files list the top <xxxx> files.
  105.          You can use any number between 2 and 100.
  106.  
  107.     /M            INCLUDE MOST POPULAR FILES     (DEFAULT = OFF)
  108.  
  109.          This will include a table at the end of the list with the 20 most
  110.          downloaded files.  If you'd like more/less than 20 files, use the /L
  111.          option.
  112.  
  113.     /N            NEW FILES ONLY                 (DEFAULT = OFF)
  114.  
  115.          /N will cause FFLIST to create a list of ONLY the new files, as
  116.          specified by the /D:<days> setting.
  117.  
  118.          If no new files are found FFLIST will create an empty list with
  119.          just the header (/H:<file) and a message saying no files were found.
  120.          It will exit with errorlevel 10 so that you may automatically trap
  121.          the errorlevel and discard the list.
  122.  
  123.     /S            SHORT DESCRIPTIONS             (DEFAULT = LONG DESCRIPTION)
  124.  
  125.          Do not include the extended descriptions.
  126.  
  127.     /T            INCLUDE DIRECTORY INFORMATION  (DEFAULT = OFF)
  128.  
  129.          This will include a table at the end of the list with the total
  130.          # of files/bytes for each directory, and a grand total of all
  131.          directories.
  132.  
  133.     /U            UPLOADER NAME                  (DEFAULT = OFF)
  134.  
  135.          Will include the name of who uploaded each file at the end of each
  136.          file description, example:
  137.  
  138.          File Description Line #1
  139.          ...
  140.          File Description Line #9
  141.          Uploaded by User Name
  142.  
  143.     /X:<file>     EXCLUDE FILES/DIRECTORIES      (DEFAULT = NONE)
  144.  
  145.          If the /X switch is used, FFLIST will exclude the file bases and
  146.          files listed in <file>.  If you have a file base or file listed in
  147.          both the include file (using /I) and the exclude file (using /X),
  148.          the exclude file will take precedence and it will not be listed.
  149.          Please see the /I option for details of how to create the <file>.
  150.  
  151.  
  152.   ┌────────────────────────────────────────────────────────────────────────┐
  153.   │                                License                                 │
  154.   └────────────────────────────────────────────────────────────────────────┘
  155.  
  156. This program may NOT be modified in any respect, for any purpose, and no part
  157. of the program may be altered, removed, disassembled, or bypassed for any
  158. reason.
  159.  
  160. You are free to distribute the publicly released version of this program as
  161. long as the complete program is distributed, and you receive no enumeration
  162. for the program.
  163.  
  164.  
  165.   ┌────────────────────────────────────────────────────────────────────────┐
  166.   │                               Warranty                                 │
  167.   └────────────────────────────────────────────────────────────────────────┘
  168.  
  169. This program is provided AS IS without any warranty, expressed or implied.
  170. This includes without limitation the fitfulness for a particular purpose or
  171. application and any warranties of merchantability.
  172.  
  173. While we have gone to great lengths to test this program, we shall not be
  174. liable for any damages, from a failure of this program or accompanying
  175. files to operate in a manner desired by the user.  We shall not be liable
  176. for any damage to data or property that may be caused directly or indirectly
  177. by use of this product.
  178.  
  179. In no event will Tri-Write Development or its representatives be liable to
  180. you for any damages, including lost profits, lost savings, or other
  181. incidental or consequential damages arising out of your use or inability to
  182. use the program, or for any claim by any other party.  Individuals using
  183. this software bear all risk as to its quality and performance.
  184.  
  185.  
  186.   ┌────────────────────────────────────────────────────────────────────────┐
  187.   │                         Contacting the Authors                         │
  188.   └────────────────────────────────────────────────────────────────────────┘
  189.  
  190. If you have any problems or suggestions you can contact us:
  191.  
  192. By Mail:
  193.  
  194.                          Tri-Write Development
  195.                               P.O. Box 53
  196.                           LaCrosse, IN  46348
  197.  
  198. By E-Mail/